home *** CD-ROM | disk | FTP | other *** search
/ Popular Request / By Popular Request (Arsenal Computer)(SysOptics Distribution System).ISO / amiga2 / ffmcd01.lha / README-FIRST < prev    next >
Text File  |  1993-10-15  |  6KB  |  125 lines
  1.  
  2.          IMPORTANT INFORMATION FOR THIS MONTHLY CD-ROM
  3.               (Updated 10-12-93)
  4.  
  5. This file contains important information that applies to this particular
  6. CD-ROM.  For general information about the Amiga Library CD-ROM's, infor-
  7. mation about the contents of this particular CD-ROM, and other important
  8. information, read the various files in the "Information" directory.  Also
  9. be sure to read the LEGAL-NOTICE, COPYRIGHT, WARRANTY, and SHAREWARE files.
  10.  
  11. Well, this is the first CD-ROM in my "monthly" series.  It represents the
  12. efforts of two people working almost full time for about six weeks, as well
  13. as a couple other people working part time for a couple weeks, or about 500
  14. person-hours effort total.  I hope the effort that went into gathering,
  15. testing, and organizing all this material shows.
  16.  
  17. Much of the work will not need to be duplicated for the second CD-ROM, but
  18. there are still lots of things to do the second CD-ROM that we just didn't
  19. have time for on this first one, like finding and installing easy to use
  20. browsing tools to make finding things easier, CD32 support, creating more
  21. individualized icons and in general polishing up the "look and feel" of the
  22. CD-ROM, improving support for the BBS/On-line sections, etc, etc.  So it
  23. may take about another six weeks before the second CD-ROM is ready.  After
  24. that, I'm hoping that we truly can get on a monthly schedule for this
  25. CD-ROM, by building on the efforts that went into previous CD-ROM's.
  26.  
  27. This CD-ROM contains approximately 84Mb of new material, 150Mb of useful
  28. tools including gcc 2.4.5, emacs 18.59, PasTeX, etc, and 404Mb of material
  29. from old floppy distributions.  All of the source to the supplied GNU
  30. binaries is provided and I have personally built all the supplied binaries
  31. from the supplied source (except GNU emacs) using the GNU C compiler on
  32. this CD-ROM, both to verify that the compiler is solid and to verify that
  33. the binaries are in fact recreatable from the supplied source code.  For
  34. more information about the contents of the CD-ROM see the files in the
  35. "Information" directory.
  36.  
  37.  
  38. INSTALLATION
  39.  
  40. This CD-ROM contains lots of utilities that are ready to run directly
  41. off the CD-ROM.  This will be slower than running off of disk, but CD-ROM
  42. drives are improving constantly, so if you have one of the newer double
  43. or quad speed drives, this should not be too painful.  You may be able
  44. to save as much as a 100Mb of disk space by running directly off the
  45. CD-ROM.
  46.  
  47. For this first disk all of the setup necessary to run most things off the
  48. CD-ROM is for you to run the script FFMCD01:Useful/s/FFCD-Startup from
  49. your S:User-Startup file, like this:
  50.  
  51.     if exists FFMCD01:Useful/s/FFCD-Startup
  52.         echo "Running FFMCD01:Useful/s/FFCD-Startup..."
  53.         execute FFMCD01:Useful/s/FFCD-Startup
  54.     endif
  55.  
  56. If you want a more customized environment, you can look at what the
  57. FFCD-Startup script is doing and use appropriate bits and pieces in
  58. your own S:User-Startup or S:FFCD-Startup.  Future disks may have a
  59. more sophisticated method of customizing the environment to allow
  60. things to run off the CD-ROM.
  61.  
  62.  
  63. GNU UTILITIES
  64.  
  65.     *    This CD-ROM contains ports of various GNU utilities that are in
  66.     various stages of stability.  See Useful/dist/gnu/README for
  67.     further information.
  68.  
  69.     *    Because of various time pressures, I was unable to get as much
  70.     on this first CD-ROM as I had hoped.  In particular, because I
  71.     am very picky about adhering completely to the conditions of
  72.     the GNU Public License, I wasn't able to get as much GNU code
  73.     included as I intend to ultimately include, since tracking down
  74.     the source for the Amiga ports, rebuilding them from that source,
  75.     and testing the resulting executables, was much more time
  76.     consuming than anticipated.  Expect this portion of the CD-ROM to
  77.     continually grow each month as more GNU ports are added.
  78.  
  79.     *    I was able to include the CBM 3.0 include files and libraries
  80.     at the last minute, but because it was last minute, I wasn't
  81.     able to arrange for the libraries to be found automatically by
  82.     gcc when needed.  This will be fixed in the next release.  For
  83.     this release you have to add the following arguments to your
  84.     link command line if your program uses any Amiga library entry
  85.     points:
  86.  
  87.         -L/gcc/os-lib -lc -lamiga
  88.  
  89.     I was able to successfully compile and run a number of the
  90.     CManual examples using commands of the form:
  91.  
  92.         gcc -o example1 example1.c -L/gcc/os-lib -lc -lamiga
  93.  
  94.     The "-lc" is required so that the linker will search the 
  95.     standard C library first and then only resolve the necessary
  96.     Amiga library entry points from /gcc/os-lib/libamiga.a.
  97.     
  98.  
  99. SAS C INCOMPATIBILITY
  100.  
  101.     *    The assign of lib: used by this CD-ROM conflicts with Lattice/SAS
  102.     C, which wants to use the same assign.  I don't have a recommended
  103.     way of dealing with this conflict yet.  I have some ideas though,
  104.     and hopefully this won't be an issue for the next CD-ROM.
  105.  
  106.     *    The simplest solution for now may be to patch your SAS C
  107.     executables to look for SLB: instead of LIB:.  However this
  108.     will cause problems with Makefiles and other such files that
  109.     reference LIB:.
  110.  
  111. USER FEEDBACK NEEDED
  112.  
  113.     *    I am always interested in hearing about things that might make
  114.     this CD-ROM more useful for users.  It is particularly important
  115.     at this stage that I get feedback from users about problems that
  116.     need fixing, or suggestions on how to make the CD-ROM more useful.
  117.  
  118.     *    You can FAX your comments to me at (602) 917-0917, however
  119.     please understand that I may not be able to respond to, or even
  120.     acknowledge receipt of, every problem report and suggestion that
  121.     arrives.
  122.  
  123.  
  124. -Fred Fish  ><>
  125.